Summary

Fixes #305 by adding a persisted Cost/Tokens toggle to the macOS menubar without changing the existing cost-first workflow.

The important behavior after the latest rebase: Tokens mode now uses CodeBurn's standard token total (inputTokens + outputTokens) for the status item, hero number, chart bars, and Activity rows. Cache read/write token fields are still carried in the payload for cache metadata and future views, but they are not counted in the visible token total. That prevents inflated numbers such as hundreds of millions of cache-read tokens being shown as today's usage.

What changed

• Add a persisted Cost | Tokens headline metric in the macOS menubar app.
• Apply the selected metric to:
  • the macOS status item,
  • the popover hero value,
  • the trend chart,
  • Activity row values and bar scaling.
• Extend menubar-json with input/output/cache read/cache write fields for current period, Activity rows, daily history, and model history.
• Preserve legacy payload decoding by defaulting newly added cache fields to 0.
• Store provider-scoped token totals in the daily cache, so provider-filtered views do not fall back to incomplete all-provider numbers.
• Preserve the current main behavior for per-provider chart history: cached history through yesterday plus fresh parsing for today.
• Update tests around menubar JSON payloads, daily aggregation, provider-scoped cache fields, and CLI status output.

Example

If today's raw provider data contains:

input:       4.0M
output:      1.9M
cache read: 500M+

Tokens mode displays 5.9M tok, matching the standard CodeBurn visible token total, not 505M+ tok from cache-read traffic.

Validation

• npx vitest run tests/menubar-json.test.ts tests/day-aggregator.test.ts tests/cli-status-menubar.test.ts tests/daily-cache.test.ts — 43/43 passed.
• npx tsc --noEmit --pretty false — passed.
• npm run build — passed.
• swift build from mac/ — passed.
• git diff --check — passed.
• Argus-style local review — PASS.
• Claude Opus 4.7 effort max review — PASS after fixing the provider-scoped cache path.
• Gemini 3.1 Pro Preview review — PASS.
• GitHub checks check, semgrep, and assess — passed.

Notes

No screenshots or raw local usage output are included here. Visual validation was done locally, but project names, prompts, paths, session IDs, exact private usage history, and private product details are intentionally omitted.